home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48_2 / disasm.tar / disasm / README < prev    next >
Text File  |  1990-04-25  |  1KB  |  38 lines
  1. This shar archive contains a rudimentary disassembler for the Saturn CPU used
  2. in the HP48SX (and other HP handhelds), as well as some utility routines.
  3. The programs that can be built are:
  4.  
  5.     dis48        - disassemble a specified range
  6.     trace        - trace and disassemble starting at an address
  7.     dobj        - disassemble object (incomplete)
  8.  
  9.     cvt        - convert a memory upload (via memory scanner)
  10.               to binary file useable by dis48 and trace
  11.     capture        - Macintosh C program to capture memory upload
  12.               (for use by cvt) from an HP48 in memory scan
  13.               mode when the SPC key is pressed
  14.  
  15.     Makefile    - Unix makefile
  16.     Makefile.mac    - Macintosh MPW makefile
  17.  
  18. The programs dis48, trace and dobj share most of the other files.
  19. The output is similar to the mnemonics used by Alonzo Gariepy with the
  20. following (macro defined) modifications:
  21.  
  22.     Hexadecimal numbers have a '$' prefixed.
  23.  
  24.     Immediate values have a '#' prefixed.
  25.  
  26.     PC-relative instructions have the format:
  27.  
  28.         pc+offset (absolute addr)
  29.  
  30.  
  31. Note that most illegal instructions are probably not noticed.
  32. All of these programs are quick hacks, and can undoubtedly stand improvements.
  33.  
  34. The output (on stdout) of the trace program, when started at address 0 results
  35. in approximately 80 pages of code discovered by tracing branch and calls
  36. as far as possible without emulating the CPU.  The error output (on stderr)
  37. is a list of addresses that are the targets of call instructions.
  38.